/**
 *
 */
package com.honeybees.framework.spring.mvc.interceptor;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

import org.springframework.web.method.HandlerMethod;
import org.springframework.web.servlet.ModelAndView;
import org.springframework.web.servlet.handler.HandlerInterceptorAdapter;

import com.honeybees.framework.spring.mvc.WebController;

/**
 * <dl>
 * <dt><b> 拦截Spring控制器 WebController </b></dt>
 * <p>
 * <dd>功能描述</dd>
 * </dl>
 * <p>
 * Copyright (C) All rights reserved.
 * </p>
 *
 * @author 李远明
 * @version 2015-10-23 15:18:32
 */
public class SpringMVCInterceptor extends HandlerInterceptorAdapter {

    // private final Logger logger = LoggerFactory.getLogger(this.getClass());

    /**
     * {@inheritDoc}
     * <p>
     * preHandle方法是进行处理器拦截用的，顾名思义，该方法将在Controller处理之前进行调用，SpringMVC中的Interceptor拦截器是链式的，可以同时存在
     * 多个Interceptor，然后SpringMVC会根据声明的前后顺序一个接一个的执行，而且所有的Interceptor中的preHandle方法都会在
     * Controller方法调用之前调用。SpringMVC的这种Interceptor链式结构也是可以进行中断的，这种中断方式是令preHandle的返
     * 回值为false，当preHandle的返回值为false的时候整个请求就结束了。
     *
     * @author 李远明
     * @version 2016-09-20 14:16:33
     */
    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler)
            throws Exception {
        // if (logger.isDebugEnabled()) {
        // logger.debug("preHandle ==> " + handler);
        // }
        if (handler instanceof HandlerMethod) { // 控制器下的方法处理请求
            HandlerMethod method = (HandlerMethod) handler;
            Object bean = method.getBean(); // XXX 该方法所属的控制器

            WebController<?> controller = (WebController<?>) bean;
            controller.setRequest(request);
            controller.setResponse(response);
        }
        // return super.preHandle(request, response, handler);
        return true;
    }

    /**
     * {@inheritDoc}
     * <p>
     * 这个方法只会在当前这个Interceptor的preHandle方法返回值为true的时候才会执行。postHandle是进行处理器拦截用的，它的执行时间是在处理器进行处理之
     * 后，也就是在Controller的方法调用之后执行，但是它会在DispatcherServlet进行视图的渲染之前执行，也就是说在这个方法中你可以对ModelAndView进行操
     * 作。这个方法的链式结构跟正常访问的方向是相反的，也就是说先声明的Interceptor拦截器该方法反而会后调用，这跟Struts2里面的拦截器的执行过程有点像，
     * 只是Struts2里面的intercept方法中要手动的调用ActionInvocation的invoke方法，Struts2中调用ActionInvocation的invoke方法就是调用下一个Interceptor
     * 或者是调用action，然后要在Interceptor之前调用的内容都写在调用invoke之前，要在Interceptor之后调用的内容都写在调用invoke方法之后。
     *
     * @author 李远明
     * @version 2016-09-20 14:18:37
     */
    @Override
    public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler,
                           ModelAndView modelAndView) throws Exception {
        // if (logger.isDebugEnabled()) {
        // logger.debug("postHandle ->> " + handler);
        // }
        // super.postHandle(request, response, handler, modelAndView);
    }

    /**
     * {@inheritDoc}
     * <p>
     * 该方法也是需要当前对应的Interceptor的preHandle方法的返回值为true时才会执行。该方法将在整个请求完成之后，也就是DispatcherServlet渲染了视图执行，
     * 这个方法的主要作用是用于清理资源的。
     *
     * @author 李远明
     * @version 2016-09-20 14:19:31
     */
    @Override
    public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex)
            throws Exception {
        // if (logger.isDebugEnabled()) {
        // logger.debug("afterCompletion ->> " + handler);
        // }
        // super.afterCompletion(request, response, handler, ex);
    }

}
